home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat7 / klog.z / klog
Encoding:
Text File  |  2002-10-03  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. KKKKLLLLOOOOGGGG((((7777))))                                                                KKKKLLLLOOOOGGGG((((7777))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      klog - kernel error logging interface
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      Minor device 0 of the _k_l_o_g driver is the interface between a process and
  13.      the kernel's error logging mechanism.  When this device is open, messages
  14.      printed by the kernel, which normally appear only in the system console
  15.      window, also are buffered by the _k_l_o_g driver.  The data obtained by
  16.      reading from this driver are the text of the kernel messages.  The driver
  17.      may be opened only for reading by a single process.  Each read causes the
  18.      requested number of bytes to be retrieved; the request is truncated if
  19.      the read request is for more than the data currently available.
  20.  
  21.      Normally, this device is opened and read by _s_y_s_l_o_g_d(1M), the system
  22.      logging daemon.
  23.  
  24.      This special device supports the following _o_p_e_n(2) flags:
  25.  
  26.           OOOO____NNNNDDDDEEEELLLLAAAAYYYY
  27.                When set a read will not block if no data is present.  If not
  28.                set, a read will block until information becomes available.
  29.  
  30.      Each _i_o_c_t_l(2) call that this special device supports has the form:
  31.  
  32.           iiiiooooccccttttllll((((ffffdddd,,,, ccccmmmmdddd,,,, aaaarrrrgggg))))
  33.  
  34.      where the format and meaning of _a_r_g vary with the specified _c_m_d as
  35.      described below:
  36.  
  37.           FFFFIIIIOOOONNNNRRRREEEEAAAADDDD
  38.                Returns the number of bytes currently available to read to the
  39.                area pointed to by _a_r_g, where _a_r_g is treated as a pointer to a
  40.                variable of type ssssiiiizzzzeeee____tttt.
  41.  
  42.           FFFFIIIIOOOONNNNBBBBIIIIOOOO
  43.                Enables or disables non-blocking mode, according to the boolean
  44.                value supplied as _a_r_g.  Enabling this mode has the same affect
  45.                as the OOOO____NNNNDDDDEEEELLLLAAAAYYYY flag for _o_p_e_n(2).
  46.  
  47.           FFFFIIIIOOOOAAAASSSSYYYYNNNNCCCC
  48.                Enables or disables asynchronous mode, according to the boolean
  49.                value supplied as _a_r_g.  When asynchronous mode is enabled, the
  50.                process group associated with the open of the special device
  51.                receives a SSSSIIIIGGGGIIIIOOOO signal when data is available to be read.
  52.  
  53.           TTTTIIIIOOOOCCCCSSSSPPPPGGGGRRRRPPPP
  54.                Set the process group for use with asynchronous I/O (FFFFIIIIOOOOAAAASSSSYYYYNNNNCCCC).
  55.                For this command, _a_r_g should contain the process group id.
  56.  
  57.           TTTTIIIIOOOOCCCCGGGGPPPPGGGGRRRRPPPP
  58.                Returns the current process group to the area pointed to by
  59.                _a_r_g, where _a_r_g is treated as a pointer to a variable of type
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. KKKKLLLLOOOOGGGG((((7777))))                                                                KKKKLLLLOOOOGGGG((((7777))))
  71.  
  72.  
  73.  
  74.                iiiinnnntttt.
  75.  
  76. FFFFIIIILLLLEEEESSSS
  77.      /dev/klog special file
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      open(2), ioctl(2), syslogd(1M)
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.